Skip to content

Conversation

@jeanschoenlaub
Copy link

@jeanschoenlaub jeanschoenlaub commented Nov 19, 2025

The suggest feature UX and business logic has changed quite a bit and I thought it should be reflected in the documentation.

UX changes:

  • Not a wizard anymore, suggest is now accessed via the left sidebar in catalog
    ---> Changed the text (eg. "click" -> "toggle")
    ---> Changed 2 screenshots illustrating the suggestion results.
    ---> Removed 1 screenshot of the wizard itself (removed not replaced because both the result and the inputs can now be seen in the same screenshot).

Business logic change:

  • Suggestion are only for the warehouse indicated on the PO (vs before having a dropdown input to select the warehouse).
    ---> Replaced a section on multi warehouse setup with a tip on demand calculation case with a sample multi warehouse setup

Also added (even though this hasn't changed):

  • 1 formula to make it clearer that the suggestions take existing stock on hand into account. It can be hard to understand for a user that Odoo suggests 0 quantities even though monthly demand > 0 if we have stock on hand.
  • That the suggestion only appear for RFQ stage in the tip as its something I often forgot when dev/testing the feature.
  • Changed the 2nd example to not only showcase how the factor work (120 % growth), but also how the based could be used to plan for specific a scenario (in this case a special event last year).

@robodoo
Copy link
Collaborator

robodoo commented Nov 19, 2025

Pull request status dashboard

@Felicious
Copy link
Contributor

Appreciate your initiative with this PR, @jeanschoenlaub !

@jero-odoo is the content owner for the Purchase app, so feel free to tag her for review whenever it's ready! (:

@jeanschoenlaub jeanschoenlaub force-pushed the 19.0-purchase-suggestions-jesc branch 4 times, most recently from 4034a39 to f8d58c0 Compare November 21, 2025 08:29
@jeanschoenlaub jeanschoenlaub force-pushed the 19.0-purchase-suggestions-jesc branch from f8d58c0 to 1f24587 Compare November 21, 2025 08:37
@jeanschoenlaub jeanschoenlaub marked this pull request as ready for review November 21, 2025 08:45
@jeanschoenlaub
Copy link
Author

Hey @jero-odoo, this is my first doecumentation PR, so please let me know if there is anything I missed / could be doing better. Thanks :).
And thanks @Felicious for the very nice base documentation, and also feel free to change wording or give me feedback as well if you'd like.

Copy link
Contributor

@jero-odoo jero-odoo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @jeanschoenlaub , This looks great! I added a few notes (mostly formatting), let me know if you have any questions.
Also, it looks like there are two images in the folder that are no longer needed in the doc (suggest-30.png and in-field.png) that should be removed. Thanks!

Once the parameters are confirmed, click :guilabel:`Compute` to calculate recommended quantities,
which are auto-filled in each product's quantities in the catalog. Adjust amounts if needed, then
click :guilabel:`Back to Quotation` to confirm the final numbers on the |RFQ|.
Once the parameters are confirmed, click :guilabel:`Add All` to add all suggestion to the
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Once the parameters are confirmed, click :guilabel:`Add All` to add all suggestion to the
Once the parameters are confirmed, click :guilabel:`Add All` to add all suggestions to the

appears. Choose a specific warehouse or leave blank to use all warehouses to calculate demand
accordingly.
<../../manufacturing/subcontracting/subcontracting_resupply>` coming from the warehouse specified
on the RFQ in the *Based on* period. The *average daily demand* is this sum of out-going moves
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
on the RFQ in the *Based on* period. The *average daily demand* is this sum of out-going moves
on the RFQ in the *Based on* period. The *average daily demand* is this sum of outgoing moves

numbers on the |RFQ|.

.. _purchase/advanced/example-suggestion:

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since the next two sections act as an example workflow, I would add a new H2 heading here (Example Workflow), to make it clearer.

@Felicious Felicious added the 2 label Nov 21, 2025
@Felicious
Copy link
Contributor

That's so sweet, @jeanschoenlaub! Thank you for the compliment 😊

The writing was great, and most importantly, you followed our RST conventions and style guide, so there wasn't too much for us to do! Our team values collaborating and communicating with the R&D team that's developing the features, and we're truly grateful that you're taking the initiative to write such a detailed changelog in the PR description and updating the documentation 😊

So happy to collaborate with you and (not to sound ungrateful) we hope this won't be your last contribution to the docs repo! 😉

After applying @jero-odoo's feedback, feel free to merge after the checks pass!

@robodoo delegate=jeanschoenlaub

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants